home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / ftn / lchstr.z / lchstr
Encoding:
Text File  |  2002-10-03  |  5.1 KB  |  148 lines
  1.  
  2.  
  3.  
  4. llllcccchhhhssssttttrrrr((((3333GGGG))))                                                          llllcccchhhhssssttttrrrr((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      cccchhhhaaaarrrrsssstttt,,,, llllcccchhhhssssttttrrrr - draws a string of characters
  10.  
  11. FFFFOOOORRRRTTTTRRRRAAAANNNN 77777777 SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee cccchhhhaaaarrrrsssstttt((((ssssttttrrrr,,,, lllleeeennnnggggtttthhhh))))
  13.      cccchhhhaaaarrrraaaacccctttteeeerrrr****((((****)))) ssssttttrrrr
  14.      iiiinnnntttteeeeggggeeeerrrr****4444 lllleeeennnnggggtttthhhh
  15.  
  16.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee llllcccchhhhssssttttrrrr((((ttttyyyyppppeeee,,,, ssssttttrrrr,,,, lllleeeennnnggggtttthhhh))))
  17.      iiiinnnntttteeeeggggeeeerrrr****4444 ttttyyyyppppeeee
  18.      cccchhhhaaaarrrraaaacccctttteeeerrrr****((((****)))) ssssttttrrrr
  19.      iiiinnnntttteeeeggggeeeerrrr****4444 lllleeeennnnggggtttthhhh
  20.  
  21. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  22.      _s_t_r      expects a pointer to the memory containing a sequence of
  23.               character id's.
  24.  
  25.      _t_y_p_e     expects one of the following symbolic constants defined in
  26.               <_g_l/_f_g_l._h>:
  27.  
  28.                          Each character id is represented
  29.                          by a single, unsigned byte.
  30.                STRB
  31.  
  32.                          Each character id is represented
  33.                          by two, consecutive unsigned
  34.                          bytes.
  35.                STR2B
  36.  
  37.  
  38.                          Each character id is represented
  39.                          by three, consecutive unsigned
  40.                          bytes.
  41.                STR3B
  42.  
  43.  
  44.                          Each character id is represented
  45.                          by four, consecutive unsigned
  46.                          bytes.
  47.                STR4B
  48.  
  49.  
  50.                          Each character id is represented
  51.                          by a 16-bit unsigned integer.
  52.                STR16
  53.  
  54.                          Each character id is represented
  55.                          by a 32-bit unsigned integer.
  56.                STR32
  57.  
  58.  
  59.      _l_e_n_g_t_h   expects the number of characters in the string.
  60.  
  61. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  62.      cccchhhhaaaarrrrsssstttt and llllcccchhhhssssttttrrrr draw a string of text using the current raster font,
  63.      color and writemask.  The first character in the string is drawn at the
  64.      current character position.  After each character is drawn, the
  65.      character's x-pixel spacing value is added to the x-coordinate of the
  66.      current character position, and if defined using ddddeeeeffffllllffffoooo, the character's
  67.      y-pixel spacing value is added to the y-coordinate.
  68.  
  69.      For strings displayed with llllcccchhhhssssttttrrrr sequences of character id's are
  70.      converted to character values using the following formulas for the _i-th
  71.      character in unsigned byte-string _s:
  72.  
  73.        STRB      _s[_i]
  74.        STR2B     (_s[2*_i]*256) + _s[2*_i+1]
  75.  
  76.  
  77.  
  78.                                                                         PPPPaaaaggggeeee 1111
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85. llllcccchhhhssssttttrrrr((((3333GGGG))))                                                          llllcccchhhhssssttttrrrr((((3333GGGG))))
  86.  
  87.  
  88.  
  89.        STR3B     ((_s[3*_i]*256) + _s[3*_i+1])*256 + _s[3*_i+2]
  90.        STR4B     (((_s[4*_i]*256) + _s[4*_i+1])*256) + _s[4*_i+2])*256 + _s[4*_i+3]
  91.  
  92.      For types SSSSTTTTRRRR11116666 and SSSSTTTTRRRR33332222, integer character id's correspond directly to
  93.      character values.
  94.  
  95.      The call cccchhhhaaaarrrrssssttttrrrr((((ssssttttrrrr)))) is equivalent in all cases to the call
  96.      llllcccchhhhaaaarrrrssssttttrrrr((((SSSSTTTTRRRR____BBBB,,,,ssssttttrrrr)))).   cccchhhhaaaarrrrsssstttt and llllcccchhhhssssttttrrrr may be used with raster fonts
  97.      defined by either ddddeeeeffffrrrraaaassss or ddddeeeeffffllllffffoooo.
  98.  
  99.  
  100.      Characters not defined in the current raster font are ignored.
  101.  
  102.  
  103. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  104.      charst, cmov, deflfo, defras, font, lstwid, strwid, getcpo
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.                                                                         PPPPaaaaggggeeee 2222
  145.  
  146.  
  147.  
  148.